home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / qseven30.zip / QSEVEN.DOC < prev    next >
Text File  |  1993-03-01  |  11KB  |  230 lines
  1.  
  2.                                Q-Seven  -  Version 3.0
  3.                       Copyright 1989-1993 by Motor City Software
  4.                                  All Rights Reserved
  5.  
  6.  
  7.     ╒══════════════════════════════════════════════════════════════════════════╕
  8.     │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Q-Seven 3.0 ░░░░│
  9.     ╘══════════════════════════════════════════════════════════════════════════╛
  10.  
  11.        This program is not Freeware.  This is SHAREWARE which means it is user-
  12.     supported software.  If you use this program for more than 30 days, you are
  13.     required to register or remove it from your system.  The registration fee
  14.     is a mere $10.00 and is not a lot to ask.
  15.  
  16.        The concept works only with your support.  If you find that you can use
  17.     this program, then a registration fee of $10.00 U.S. funds will help defray
  18.     the development cost and encourage the authorship of other programs that
  19.     might be useful to you.  A  Registration Form for this purpose is included
  20.     with the distribution archive and is called QSEVEN.REG
  21.  
  22.        QSeven is Copyrighted 1991 by Motor City Software and all rights are
  23.     reserved. You may copy this program and documentation for backup purposes.
  24.     You also may copy and share UNMODIFIED copies of the program package,
  25.     providing that the copyright notice is reproduced and included on all
  26.     copies.
  27.  
  28.        You may not sell the product for a fee and/or distribute the product
  29.     along with other products without expressed written permission from Motor
  30.     City Software, nor may you modify or remove the Copyright Notice from the
  31.     program or the documentation.
  32.  
  33.  
  34.     
  35.  
  36.     ╒══════════════════════════════════════════════════════════════════════════╕
  37.     │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Q-Seven 3.0 ░░░░│
  38.     ╘══════════════════════════════════════════════════════════════════════════╛
  39.  
  40.  
  41.        Q-Seven is an online ANSI graphics "Over and Under" game for QuickBBS
  42.     and RemoteAccess BBS.
  43.  
  44.     This version supports QuickBBS V2.75, 2.76, and RemoteAccess V1.1x, and
  45.     2.00
  46.  
  47.  
  48.  
  49.        It allows users to gamble their time remaining while online.  The program
  50.     is pretty straight forward and and easy to install.  It does require ANSI
  51.     graphics to be turned ON by the user and does require the DOS ANSI.SYS
  52.     driver to be installed on the host computer.  If a caller tries to run
  53.     Q-Seven and does not have graphics turned on, the program will notify the
  54.     user that graphics are required.  It will then return control to the BBS.
  55.  
  56.        Q-Seven allows the BBS Sysop to define the maximum number of turns
  57.     allowed per user, per day as well as the maximum number of minutes a user
  58.     may accumulate while in the game.  Once a user has reached a maximum number
  59.     of accumulative minutes, the user is not allowed to access the game until
  60.     the next day.  Once a user has reached the maximum number of turns per day
  61.     Q-Seven will not allow the user to take any more turns.
  62.  
  63.  
  64.     
  65.  
  66.     ╒══════════════════════════════════════════════════════════════════════════╕
  67.     │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Q-Seven 3.0 ░░░░│
  68.     ╘══════════════════════════════════════════════════════════════════════════╛
  69.  
  70.  
  71.     Q-Seven is easy to install.  A type 7 menu entry may be used, as follows:
  72.  
  73.     Optional Data : D:\BBS\DOORS\Q7\QSEVEN.EXE 2 100 100 /N*N
  74.  
  75.     Commandline Parameters:
  76.  
  77.       QSEVEN <coin_value> <max_mins> <max_turns> [/Bbank_path] [/Wn] [/Nn]
  78.  
  79.     Where - Coin_value is a number from 1 to 10.      This tells Q-Seven
  80.             the value of a coin in minutes.  For example, if you enter
  81.             a value of 2, each coin will have a value of 2 minutes.  I
  82.             have found that a value of 2 works well.
  83.  
  84.           - Max_mins is a number from 1 to 1000.      This tells Q-Seven
  85.             the maximum number of minutes a user can win while in the
  86.             program.  This includes the user's current time plus any
  87.             winnings accumulated during play.  If a user meets or exceeds
  88.             this number, the user will be congratulated and politely asked
  89.             to try again tomorrow.  The user will not be allowed access to
  90.             Q-Seven until the next day.
  91.  
  92.             NOTE: This number will include the time the user already has.
  93.             If this was set to 100 and the user had 99 minutes when he
  94.             entered the program, he would be allowed to win only one
  95.             minute.
  96.  
  97.           - Max_turns is a number from 1 to 1000.  This tells Q-Seven
  98.             the maximum number of turns a player may take per day.  If
  99.             this number is reached, the user will not be allowed to take
  100.             any more turns.
  101.  
  102.  
  103.     
  104.  
  105.     Installation Continued.
  106.  
  107.  
  108.           - /B tells Q-Seven that you wish to use time banking supprt.
  109.             What this means is that if a player is in Q-Seven and wins
  110.             an amount of time that would overstep a system event, Q-Seven
  111.             will create a file called THEBANK.EXT.  This file would then
  112.             contain the user's name and the number of minutes to
  113.             automatically deposit in the user's time bank account.
  114.  
  115.             For example, if there is a system event in 60 minutes and the
  116.             player wins 80 minutes Q-Seven will give the player 60 minutes
  117.             of winnings and automatically bank the rest (20 minutes).
  118.  
  119.             You may also supply a path to where THEBANK.EXT file will be
  120.             created. For example,   /Bc:\bbs   would cause THEBANK.EXT
  121.             file to be created in the BBS directory on drive C:. Note that
  122.             there is no space between the /B and the path.
  123.  
  124.             See your Time Bank utility documentation to see if it supports
  125.             this file or download the latest version of RATS ( RATS200.ZIP )
  126.             from any Motor City Software Support site!
  127.  
  128.  
  129.  
  130.           - /W tells Q-Seven the maximum number of coins a player may
  131.             wager per turn.  This may be a value from 1 to 999 and will
  132.             default to 10 if not specified.
  133.  
  134.           - /Nn allows you to pass the node number to QSeven. This is used
  135.             for the logfiles, and the Status Bar on the screen.
  136.  
  137.     
  138.  
  139.     ╒══════════════════════════════════════════════════════════════════════════╕
  140.     │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Q-Seven 3.0 ░░░░│
  141.     ╘══════════════════════════════════════════════════════════════════════════╛
  142.  
  143.  
  144.        The Q-Seven archive comes with a few files needed by the program.  You
  145.     can run Q-Seven from any directory. It looks for the ExitInfo.BBS and the
  146.     Dorinfo1.Def in the current directory, and reads all of its own files from
  147.     the directory containing the .EXE file.
  148.  
  149.        The files that come with the archive are:
  150.  
  151.     QSEVEN.EXE                       This is the program
  152.     QSEVEN.ANS                       This is the formatted graphic used
  153.     QSEVEN.ASC                       This is the non-color graphic used
  154.     QSEVEN.HLP                       This is a formatted help file
  155.     QSEVEN.DOC                       This document
  156.  
  157.     NOTE: Do not edit or change the contents of QSEVEN.ANS, QSEVEN.ASC
  158.           or QSEVEN.HLP. These files are formatted specifically for the
  159.           program.
  160.  
  161.     In addition to these files, Q-Seven also creates and maintains some files
  162.     it needs to operate.  These are:
  163.  
  164.     QSEVEN.DTE                       Julian date file. Erase this file if
  165.                                      you need to reset the game that day.
  166.     QSEVEN.USR                       List of users who have reached a daily
  167.                                      limit and are not allowed to play again
  168.                                      that day.
  169.     QSEVEN.TRN                       This keeps track of the user turn counts
  170.                                      for the day.
  171.     QSEVEN.LOG                       This is the player log.  It is a circular
  172.                                      text file which tracks the last 15 players
  173.                                      and how they did.
  174.     THEBANK.EXT                      External time bank utility file.  This
  175.                                      file is created and maintained by Q-Seven
  176.                                      and is read by The Bank v1.00 and later.
  177.                                      Do not delete this file.  The Bank will
  178.                                      delete it each time it has read it.
  179.     Q7_##.ERR                        Reference to any run time errors that
  180.                                      might occur. ## is replaced by the node
  181.                                      number.
  182.  
  183.     
  184.  
  185.     ╒══════════════════════════════════════════════════════════════════════════╕
  186.     │░░░░░░ MORE ON TIME BANKING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Q-Seven 3.0 ░░░░│
  187.     ╘══════════════════════════════════════════════════════════════════════════╛
  188.  
  189.  
  190.        When The Bank is run and locates THEBANK.EXT, it will read it through to
  191.     the end of the file updating or adding user accounts as needed.  The format
  192.     of THEBANK.EXT is:  User Name:Time
  193.  
  194.        For example, if JOHN DOE wins 80 minutes and Q-Seven deposits 20 minutes
  195.     into his account, the following line will be appended to THEBANK.EXT:
  196.  
  197.                                 JOHN DOE:20
  198.  
  199.        A user's name can appear in this file more than once.  The Bank will
  200.     handle it properly.  For more details, see The Bank 1.00 or later, or
  201.     RATS 1.01 or later.
  202.  
  203.  
  204.     ╒══════════════════════════════════════════════════════════════════════════╕
  205.     │░░░░░░ OTHER STUFF ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  206.     ╘══════════════════════════════════════════════════════════════════════════╛
  207.  
  208.  
  209.        Q-Seven also allows the Sysop to plug his/her BBS by displaying a file
  210.     called QSEVEN.TXT, if it exists.  So, if there's a message you'd like to
  211.     display before Q-Seven draws it's screen, just create an ASCII text file
  212.     called QSEVEN.TXT and put it in the same directory as Q-Seven and it will
  213.     be displayed.
  214.  
  215.  
  216.       Sysop function keys:
  217.  
  218.                [ALT]-[C] : Chat with word wrap.
  219.                            [ESC] to quit chat.
  220.                [ALT]-[H] : Hang up on user.
  221.                [ALT]-[J] : Jump to DOS.
  222.                [ALT]-[T] : Unconditionally return user to BBS.
  223.               Up Arrow   : Increase users time by 2 minutes.
  224.               Down Arrow : Decrease users time by 2 minutes.
  225.  
  226.  
  227.  
  228.     
  229.  
  230.